home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / xactl.z / xactl
Encoding:
Text File  |  1998-10-20  |  17.3 KB  |  331 lines
  1.  
  2.  
  3.  
  4. xxxxaaaaccccttttllll((((1111mmmm))))                                                            xxxxaaaaccccttttllll((((1111mmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      xactl - extended accounting control
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      xxxxaaaaccccttttllll [_o_p_t_i_o_n_s...] _s_u_b_c_o_m_m_a_n_d
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _x_a_c_t_l command is used to query or modify extended accounting behavior
  16.      on a running system.  The particular operation to be performed is
  17.      specified by _s_u_b_c_o_m_m_a_n_d, which may be in upper, lower or mixed case.
  18.  
  19.      The valid subcommands are:
  20.  
  21.      aaaalllllllloooowwwwnnnneeeewwww
  22.           Permits any member of an array session to start a new array session
  23.           using the _n_e_w_a_r_r_a_y_s_e_s_s(2) system call.  The handle of the array
  24.           session is specified with the ----aaaasssshhhh option.  The user must be
  25.           privileged to invoke this subcommand.  Notice that it is normally
  26.           the case that a member of an array session can invoke _n_e_w_a_r_r_a_y_s_e_s_s
  27.           successfully; aaaalllllllloooowwwwnnnneeeewwww would be used to undo a previous rrrreeeessssttttrrrriiiiccccttttnnnneeeewwww
  28.           subcommand.
  29.  
  30.      fffflllluuuusssshhhhaaaallllllllsssseeeessssssssiiiioooonnnnssss
  31.           Similar to the fffflllluuuusssshhhhsssseeeessssssssiiiioooonnnn subcommand, except that accounting
  32.           information for _a_l_l array sessions that are currently active will be
  33.           flushed.  The user must be privileged to invoke this subcommand.
  34.  
  35.      fffflllluuuusssshhhhsssseeeessssssssiiiioooonnnn
  36.           Flushes any accounting information that has been accumulated for a
  37.           particular array session.  The handle of the array session is
  38.           specified with the ----aaaasssshhhh option.  If array session accounting is
  39.           active (see _e_x_t_a_c_c_t(5)), then a record reporting the resource usage
  40.           information that has been accumulated by the array session will be
  41.           written.  Array session accounting records that are written using
  42.           this operation will be marked as "flushed" to indicate that
  43.           subsequent records for the same array session may be forthcoming.
  44.           Under normal circumstances, the resource usage for an array session
  45.           only includes the resources used by processes that have already
  46.           terminated; the flushed accounting data will not include the
  47.           resources used by any members of the array session that are still
  48.           running.  The user must be privileged to invoke this subcommand.
  49.  
  50.      ggggeeeettttddddffffllllttttssssppppiiii
  51.           Prints the current default Service Provider Information, which will
  52.           be used to identify all array sessions that do not override the
  53.           system default.
  54.  
  55.      ggggeeeettttddddffffllllttttssssppppiiiilllleeeennnn
  56.           Prints the number of bytes of storage that is allocated to each new
  57.           array session for Service Provider Information.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. xxxxaaaaccccttttllll((((1111mmmm))))                                                            xxxxaaaaccccttttllll((((1111mmmm))))
  71.  
  72.  
  73.  
  74.      ggggeeeettttssssaaaaffff
  75.           Prints the current session accounting format (typically "1" or "2").
  76.  
  77.      ggggeeeettttssssppppiiii
  78.           Prints the Service Provider Information associated with a particular
  79.           array session.  The handle of the array session is specified with
  80.           the ----aaaasssshhhh option.
  81.  
  82.      ggggeeeettttssssppppiiiilllleeeennnn
  83.           Prints the number of bytes of storage that have been allocated for
  84.           Service Provider Information in a particular array session.  The
  85.           handle of the array session is specified with the ----aaaasssshhhh option.
  86.  
  87.      rrrreeeessssttttrrrriiiiccccttttnnnneeeewwww
  88.           Restricts any member of an array session from starting a new array
  89.           session using the _n_e_w_a_r_r_a_y_s_e_s_s(2) system call; any attempt to do so
  90.           will result in an EPERM error.  The handle of the array session is
  91.           specified with the ----aaaasssshhhh option.  This restriction can be removed
  92.           later using the aaaalllllllloooowwwwnnnneeeewwww subcommand.
  93.  
  94.      sssseeeessssssssiiiioooonnnniiiinnnnffffoooo
  95.           Prints any accounting information that has been accumulated for a
  96.           particular array session.  The handle of the array session is
  97.           specified with the ----aaaasssshhhh option.  If the array session's accounting
  98.           information has been flushed, then the accumulated charged
  99.           accounting data from the time of the last flush will also be
  100.           printed.  Note that if session accounting has not been enabled in
  101.           the system, then most data will appear as "0".
  102.  
  103.      sssseeeettttddddffffllllttttssssppppiiii
  104.           Set the default Service Provider Information that is to be assigned
  105.           to any array session which has not set its own Service Provider
  106.           Information.  This will take effect immediately, even for running
  107.           array sessions.  For details on _S_P_I-_i_n_f_o, see "Specifying Service
  108.           Provider Information" below.  The user must be privileged to invoke
  109.           this subcommand.
  110.  
  111.      sssseeeettttddddffffllllttttssssppppiiiilllleeeennnn
  112.           Sets the number of bytes of storage that will be allocated to each
  113.           new array session for Service Provider Information to the value
  114.           specified by the ----lllleeeennnnggggtttthhhh option.  The new length must be in the
  115.           range of 0 to 1024.  Note that once an array session has been
  116.           created, it can change the amount of storage it has allocated for
  117.           Service Provider Information with the sssseeeettttssssppppiiiilllleeeennnn subcommand or the
  118.           _a_r_s_o_p system call.  The user must be privileged to invoke this
  119.           subcommand.
  120.  
  121.      sssseeeettttssssaaaaffff
  122.           Sets the current session accounting format to the value specified by
  123.           the ----ffffoooorrrrmmmmaaaatttt option.  The new format must be either "1" or "2".  All
  124.           subsequent session accounting records that are generated by the
  125.           kernel will be in the specified format.  Note that the session
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. xxxxaaaaccccttttllll((((1111mmmm))))                                                            xxxxaaaaccccttttllll((((1111mmmm))))
  137.  
  138.  
  139.  
  140.           accounting format is different than the service provider information
  141.           format.  The user must be privileged to invoke this subcommand.
  142.  
  143.      sssseeeettttssssppppiiii
  144.           Set the Service Provider Information associated with a particular
  145.           array session.  The handle of the array session is specified with
  146.           the ----aaaasssshhhh option.  For details on specifying the new service provider
  147.           information, see "Specifying Service Provider Information" below.
  148.           The user must be privileged to invoke this subcommand.
  149.  
  150.      sssseeeettttssssppppiiiilllleeeennnn
  151.           Changes the number of bytes of storage that is allocated for Service
  152.           Provider Information in a particular array session.  The handle of
  153.           the array session is specified with the ----aaaasssshhhh option and the new
  154.           length is specified with the ----lllleeeennnnggggtttthhhh option.  The new length must be
  155.           in the range of 0 to 1024.  The user must be privileged to invoke
  156.           this subcommand.
  157.  
  158. GGGGEEEENNNNEEEERRRRAAAALLLL OOOOPPPPTTTTIIIIOOOONNNNSSSS
  159.      The behavior of _x_a_c_t_l can be modified by the following options.  They
  160.      must be specified before the subcommand name.  Options that are
  161.      irrelevant to a particular subcommand will be silently ignored.
  162.  
  163.      ----aaaasssshhhh _h_a_n_d_l_e or ----hhhh _h_a_n_d_l_e
  164.           For subcommands that act on a single array session, this specifies
  165.           the handle of the specific array session.  The default is to use the
  166.           array session containing the process running _x_a_c_t_l.
  167.  
  168.      ----bbbbrrrriiiieeeeffff or ----bbbb
  169.           Specifies that output should be briefer than normal, generally by
  170.           omitting headers and other explanatory information.  This would
  171.           useful when _x_a_c_t_l is called from a script.
  172.  
  173.      ----ffffoooorrrrmmmmaaaatttt _f_m_t or ----ffff _f_m_t
  174.           Specifies a format value.  For the sssseeeettttssssaaaaffff subcommand, this would be
  175.           the session accounting format, which must be either "1" or "2".  For
  176.           subcommands that involve service provider information, this
  177.           specifies an explicit format to be used when parsing command line
  178.           options and/or printing the service provider information (see below
  179.           for more details).  In this case, valid values are "0", "1" or "2".
  180.  
  181.      ----lllleeeennnnggggtttthhhh _l_e_n_g_t_h or ----llll _l_e_n_g_t_h
  182.           For the sssseeeettttddddffffllllttttssssppppiiiilllleeeennnn and sssseeeettttssssppppiiiilllleeeennnn subcommands, this specifies the
  183.           new length of the service provider information buffer.  For
  184.           subcommands that involve the service provider information itself,
  185.           this specifies the number of bytes of service provider information
  186.           that should actually be read or written for the array session.  If
  187.           this is less than the amount of storage allocated to the array
  188.           session for service provider information, then any remaining storage
  189.           will be padded with zeroes.  In this case the default is to use
  190.           exactly as many bytes as have been allocated to the array session
  191.           for service provider information (see ggggeeeettttddddffffllllttttssssppppiiiilllleeeennnn and ggggeeeettttssssppppiiiilllleeeennnn).
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. xxxxaaaaccccttttllll((((1111mmmm))))                                                            xxxxaaaaccccttttllll((((1111mmmm))))
  203.  
  204.  
  205.  
  206. SSSSPPPPEEEECCCCIIIIFFFFYYYYIIIINNNNGGGG SSSSEEEERRRRVVVVIIIICCCCEEEE PPPPRRRROOOOVVVVIIIIDDDDEEEERRRR IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  207.      The sssseeeettttssssppppiiii and sssseeeettttddddffffllllttttssssppppiiii subcommands allow the user to specify the
  208.      service provider information associated with a particular array session
  209.      or the default system settings, respectively.  Because service provider
  210.      information is typically made up of several free-format fields, it may
  211.      take several command line options to fully specify it.  For more
  212.      information on service provider information, see _a_r_r_a_y__s_e_r_v_i_c_e_s(5).
  213.  
  214.      Both format 1 and format 2 service provider information are supported, as
  215.      well as a "format 0", which indicates unformatted data.  The format to be
  216.      used can normally be inferred by _x_a_c_t_l from the current length of the
  217.      array session's service provider information: a length of 64 implies
  218.      format 1, a length of 128 implies format 2, and any other length implies
  219.      "format 0".  However, the ----ffffoooorrrrmmmmaaaatttt option can be used to explicitly force
  220.      a particular format to be used.
  221.  
  222.    FFFFoooorrrrmmmmaaaatttt 0000 OOOOppppttttiiiioooonnnnssss
  223.      These options are mutually exclusive with each other and incompatible
  224.      with the Format 1 and Format 2 options.
  225.  
  226.      ----cccclllleeeeaaaarrrr
  227.           Reset the service provider information to zeroes.
  228.  
  229.      ----ddddeeeeffffaaaauuuulllltttt
  230.           Reset the service provider information to the system default (same
  231.           as ----cccclllleeeeaaaarrrr for the sssseeeettttddddffffllllttttssssppppiiii subcommand).
  232.  
  233.      ----ffffiiiillllllll _b_y_t_e
  234.           Fill the entire service provider information area with the value
  235.           _b_y_t_e, an unsigned single-byte value.
  236.  
  237.    FFFFoooorrrrmmmmaaaatttt 1111 OOOOppppttttiiiioooonnnnssss
  238.      These options are incompatible with the Format 0 options.  They also
  239.      cannot be specified if the current length of the affected service
  240.      provider information area is less than 64 bytes.  These options _c_a_n by
  241.      specified for Format 2 as well.
  242.  
  243.      ----ccccoooommmmppppaaaannnnyyyy _s_t_r_i_n_g
  244.           _s_t_r_i_n_g contains up to 8 bytes of (typically ASCII) data to be stored
  245.           in the ssssppppiiii____ccccoooommmmppppaaaannnnyyyy field of the service provider information.
  246.  
  247.      ----iiiinnnniiiittttiiiiaaaattttoooorrrr _s_t_r_i_n_g
  248.           _s_t_r_i_n_g contains up to 8 bytes of data to be stored in the
  249.           ssssppppiiii____iiiinnnniiiittttiiiiaaaattttoooorrrr field of the service provider information.
  250.  
  251.      ----oooorrrriiiiggggiiiinnnn _s_t_r_i_n_g
  252.           _s_t_r_i_n_g contains up to 16 bytes of data to be stored in the
  253.           ssssppppiiii____oooorrrriiiiggggiiiinnnn field of the service provider information.
  254.  
  255.      ----ssssppppiiii _s_t_r_i_n_g
  256.           _s_t_r_i_n_g contains up to 16 bytes of data to be stored in the ssssppppiiii____ssssppppiiii
  257.           field of the service provider information.
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. xxxxaaaaccccttttllll((((1111mmmm))))                                                            xxxxaaaaccccttttllll((((1111mmmm))))
  269.  
  270.  
  271.  
  272.    FFFFoooorrrrmmmmaaaatttt 2222 OOOOppppttttiiiioooonnnnssss
  273.      These options are incompatible with the Format 0 options.  They also
  274.      cannot be specified if "-format 1" was specified, or if the current
  275.      length of the affected service provider information area is less than 128
  276.      bytes.
  277.  
  278.      ----jjjjoooobbbbnnnnaaaammmmeeee _s_t_r_i_n_g
  279.           _s_t_r_i_n_g contains up to 32 bytes of data to be stored in the
  280.           ssssppppiiii____jjjjoooobbbbnnnnaaaammmmeeee field of the service provider information.
  281.  
  282.      ----ssssuuuubbbbttttiiiimmmmeeee _t_i_c_k_s
  283.           _t_i_c_k_s is a signed 64-bit value to be stored in the ssssppppiiii____ssssuuuubbbbttttiiiimmmmeeee field
  284.           of the service provider information.
  285.  
  286.      ----eeeexxxxeeeeccccttttiiiimmmmeeee _t_i_c_k_s
  287.           _t_i_c_k_s is a signed 64-bit value to be stored in the ssssppppiiii____eeeexxxxeeeeccccttttiiiimmmmeeee
  288.           field of the service provider information.
  289.  
  290.      ----wwwwaaaaiiiittttttttiiiimmmmeeee _t_i_c_k_s
  291.           _t_i_c_k_s is a signed 64-bit value to be stored in the ssssppppiiii____wwwwaaaaiiiittttttttiiiimmmmeeee
  292.           field of the service provider information.
  293.  
  294. NNNNOOOOTTTTEEEESSSS
  295.      Extended accounting is not generally enabled in IRIX by default.  See
  296.      _e_x_t_a_c_c_t(5) for more details on using extended accounting.
  297.  
  298. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  299.      arsctl(2), arsop(2), array_sessions(5), extacct(5).
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.